home
***
CD-ROM
|
disk
|
FTP
|
other
***
search
/
Belgian Amiga Club - ADF Collection
/
BS1 part 41.zip
/
BS1 part 41
/
Disk Magic v1.0.adf
/
DISKMAGIC.DOC
< prev
next >
Wrap
Text File
|
1988-12-27
|
48KB
|
1,924 lines
TABLE OF CONTENTS
1.0 INTRODUCTION
2.0 GETTING STARTED
3.0 GETTING AROUND
3.1 Two File Select windows.
3.2 Parameters/Swap/Source/Destination
3.3 Front Gadget
3.4 Back Gadget
3.5 Drag Bar
3.6 Left Mouse Button
3.7 Right Mouse Button
3.8 Sound Toggle
3.9 Color mode Toggle
3.10 Menu mode Toggle
3.11 Improvements
4.0 DIRECTORY GADGETS AND MENUS
4.1 Start Up Directories
4.2 User defined directories
5.0 BASE FUNCTIONS
5.1 Highlighting Functions
5.2 Directory Functions
5.3 Type/Display Functions
5.4 File Functions
6.0 USER DEFINED GADGETS AND MENUS
6.1 Directory Gadgets And Menus
6.2 Program Menus
7.0 DISK MAGIC DEFINITION FILE
7.1 Color mode definition
7.2 Archive Pause Timer
7.3 Picture Pause Timer
7.4 Sound On/Off
7.5 Start up Source Directory
7.6 Start up Destination Directory
7.7 On Screen Directory Names
7.8 On Screen User Defined Directories
7.9 Program Menu Catagories
7.10 User Defined Directory Menu Names
7.11 User Defined Menu Directories
7.12 User Defined Menu Program Names
7.13 User Defined Menu Programs
7.14 User Defined Comments
7.15 User Menu Command Format Definitions
8.0 ALPHABETICAL LIST OF COMMANDS
APPENDIX A. Shareware Copyright Notices
1.0 INTRODUCTION
WELCOME TO THE WORLD OF DISK MAGIC !
DISK MAGIC is a user friendly CLI replacement program and
graphics interface program with easily defined directories
and functions. It provides a base set of built in
functions such as file and directory copy/delete with
functions such as PRINT being run in background mode. This
program also has a built in directory catalog list function,
and global rename function. There are 14 user definable
directory gadgets and 18 user definable menu directories.
Also there are 108 user definable program menus with a
possibility of executing multiple commands by each menu
item.
DISK MAGIC is also a menu program driver. From CLI or your
startup sequence you can run DISK MAGIC as follows:
runb DISKMAGIC i
This will run the program in background mode and come up
with a menu bar that displays DATE, TIME, CHIP, FAST and TOTAL
memory parameters. You can define a set of 6 menus that each
contain 18 items each of which will execute the programs you
define. The following sections will describe both modes.
2.0 GETTING STARTED
First make (1) one backup copy of your DISK MAGIC disk.
This disk has no copy protection to allow the user to place
this software on any hard disk or any Amiga the
purchaser owns.
The DISK MAGIC files on the supplied disk are as follows:
DISKMAGIC
DISKMAGIC.info
DISKMAGIC.data
DISKMAGIC.pic4
DISKMAGIC.pic8
Please take the time to read the documentation to learn how
to define the environment for DISK MAGIC.
All DISK MAGIC files must be first copied to your
workbench (TM) disk or a hard disk. The next version of
DISKMAGIC will come with workbench and the AMIGA DOS (TM)
operating system on version 2.0.
The files in the 'C' directory must be copied to your sys:c
directory and are listed as follows:
runb - run a program in background mode.
* ARC - Archive and de-archive file compression program.
* ARC.doc
* ZOO - Archive and de-archive file compression program.
* ZOO.man
* PAK - Archive and de-archive file compression program.
* PAK.doc
* PKAX - Archive de-compression file program by PAKWARE.
Also included on the DISK MAGIC disk is a public domain
hard drive backup utility called MRbackup.
Each of the files (*) above are shareware programs that are
included in this package to make it easy for you the user to
obtain the programs that DISK MAGIC supports.
Included on the DISK MAGIC DISK are a number of public
domain programs and shareware programs. These are included
as a service to supply the user with the complete tools to
archive and de-archive files. THe programs are either
freely distributable or permission was obtained from the
author to supply you with these tools.
FIRST SOME DEFINITIONS:
A. Public Domain - These programs are freely distributable
and can be used at no cost to you.
B. Shareware - These programs are included on the disk to
the user and if the user finds these programs useful
then the user is asked to pay a registration fee. This
fee is to support updates and to support the people that
write the software. Different policies are in effect
for each program and these policies can be found in
APPENDIX A or by typing the name of the program and a
carriage return. These programs are not free and by your
own good conscience we here at DMH hope you will support
the software developers of these excellent programs.
3.0 GETTING AROUND
The following section describes how to select files and
directories, how to get to other screens and how to get
to other directories.
All 4 DISK MAGIC files must be in the same directory.
Also the execute and run commands must be in the C
directory for this program to work. The following
sections refer to figure 1 seen below and referenced by
the numbers in the closed parentheses ().
figure 1.
3.1 Two File Select windows.
The DISK MAGIC screen has two files select windows at
the top (1). One is the source screen and one is the
destination screen. The MAGIC WAND in the center points
at the Source select window. In these two windows both
files and directories are displayed. The FILE names in
white are actual files and the names in RED are the
DIRECTORIES. The next section describes how to switch
between the source and destination directories.
3.2 Parameters/Swap/Source/Destination
DISK MAGIC has an entry line at the bottom of the
screen. This is the parameter entry field (6). This
field can be clicked on and the user can enter
function parameters to be passed to a given function.
Examples are as follows:
P: The string to be passed:
GRENAM - Input to the function as
described in section 5.4 and
section 8.0.
RUN - parameters to be passed to
program being run.
EXECUTE - parameters to pass to the file
being executed.
The two text entry lines in the center of the screen
below each file select window indicate the current
source and destination directories that are displayed
(3). The one that is highlighted in red is the source
directory and the other is the destination directory.
Through the rest of this document when referring to the
source directory or the destination directory The one
that is highlighted in red is the source directory and
the other is the destination directory. To change the
source directory to the destination directory just
click with the left mouse button on the MAGIC WAND in
the center of the screen and the directories will
change. The WAND points to the source directory. Also,
you can click in each one of these directories and type
in a new directory and hit the carriage return key and
the new directory will be loaded automatically.
3.3 Front Gadget
The front gadget moves DISK MAGIC's screen to be the
front screen in the system (7). This gadget is set up
in a slightly different method from the normal front
and back gadgets. when DISK MAGIC is not busy doing
processing you can click any where on the front gadget
and this will move the screen to the front. This part
of the screen is really part of the window and is
really not part of the screen front and back. If DISK
MAGIC is busy (like arcing or dearcing files) you can still
move the screen to the front or back by clicking at the very
top portion of the front or back gadget and this will move
the screen so you can get to your terminal program or any
other function you have running.
3.4 Back Gadget
This is the same as the front gadget accept it will
move the screen to the back (7).
3.5 Drag Bar
The Drag bar is only 2 pixels wide and is at the top
of the screen (7). This allows you to slide the screen
up and down.
3.6 Left Mouse Button
The left mouse button is used to select files and
directories in the file selection area, to activate
the gadgets for DISK MAGIC, and also to stop
processing. This is done by clicking anywhere on the
screen that is not a GADGET. If this is done DISK
MAGIC will finish the file that is being worked on and
then terminate processing.
3.7 Right Mouse Button
The right mouse button is used to get a given directory
in the (1) file selection windows. For an example;
The source directory is df0:
In the file select area (1) you see a red file
name 'C" indicating that this is a directory.
This is the command directory. Place the pointer
over the red file name and click the RIGHT mouse
button on the directory name. The Source
directory now becomes df0:C and the source file
select area now displays all the files in that
directory.
3.8 Sound Toggle
The button in figure 1 labeled 'S' (2) is to toggle
the sound on or off.
3.9 Color mode toggle
Color mode toggle allows the user to switch between 4
color mode and 8 color mode. Figure 1 does not show
this button. It is located to the left of the ZOO
button and is labeled 'C'. Also, the picture files
DISKMAGIC.pic4 and DISKMAGIC.pic8 can be modified by
any paint program to the users desired color scheme.
The default color can be defined in the user definition
file and is described in section 7.
3.10 Menu mode Toggle
This button (8) labeled 'I' toggles between menu mode
and graphics mode. The benefit of menu mode is that it
eliminates the over head of the screen and graphics
display when only the menu command line is needed.
NOTE: in menu mode the DIRECTORY MENU ITEMS ARE NOT
VALID and only the MENU ITEM 'GET DISK MAGIC' is valid.
By selecting this menu item you are returned to the
graphics mode. Also, in menu mode all programs are
executed from the menu with just the user defined command
line and no files or directories are added. In this mode
DISK MAGIC allows the user to access any command in any
directory at the click of a button using the pull down
menus.
3.11 IMPROVEMENTS
Two improvements have been made.
1. When ever you operate the functions DEARC, DEZOO, ZOOLST,
ARCLST, or PAKLST you have the option of changing the mode
of the listing to one of the following:
a. In the parameter entry window (6) you may enter a
number from (1-99) before you operate any of the above
functions. If you enter a 1 then the result listing of
the above functions will wait for a carriage return
from the user.
b. If you enter a number from (2-99) DISK MAGIC will
display the results for the entered number of seconds
and then go on to the next file.
2. When ever you show a picture file you have the option of
changing the mode of the listing to one of the following:
a. In the parameter entry window you may enter a number
from (1-99) before you operate the show function. If
you enter a 1 then each of the selected picture files
will be shown and DISK MAGIC will wait until the user
clicks on the hidden close box at the top left hand
corner of the screen.
b. If you enter a number from (2-99) DISK MAGIC will
display the selected pictures for the entered number of
seconds and then go on to the next file.
If no entry is made in the P: window then the operation will
occur in the same mode as it was defined by the user
defined data file or the last mode change the user made.
4.0 DIRECTORY GADGETS AND MENUS
4.1 Start Up Directories
The Start up directories (those used on start up for
the source and destination directories) can be defined
by the user and are described in section 7.0.
4.2 User defined directories
There are 14 user gadget directories (6) that can be
defined by the user and also 18 user defined menu
directories which are described in section 7.0.
5.0 BASE FUNCTIONS
5.1 Highlighting Functions
ALL -
Select ALL files in the current highlighted
source directory, including the ones "scrolled
off" the window.
ALLDIRS -
Highlights all directories.
ALLWIND -
Highlights all files in the highlighted source
window (9 at a time). This is handy to archive a
directory that is two large for a 3 1/2" disk.
CLEAR -
De-select all selected files in the highlighted
source directory.
CLRDIRS -
Clears all selected directories in the
highlighted source directory.
CLRWIND -
Clears all files in the highlighted source
window.
5.2 Directory Functions
CATLIST -
This will list all files and directories and
sub files and sub directories to the printer. This
function starts from the Highlighted source directory
found in the highlighted directory window.
COPY -
Copy selected files and directories to the
directory specified in the unhighlighted
destination string gadget. It must be an existing
directory path and CAN go across devices. You
should be able to enter paths relative to the
current directory. NOTE! you can select both
directories and files to be copied now. and all
are done at the same time.
DELETE -
Delete selected files and directories in the
Highlighted source directory.
GETDIR -
Gets the current directory in the highlighted
source window. You can also click on the
directory windows and then type in a new
directory. Upon hitting carriage return the new
directory is read in.
MAKDIR -
This will create the directory that you have
typed in the highlighted source window gadget. You
may use relative paths.
ex: click on the highlighted string gadget and
enter the following:
ram: ---> ram:newdirectoryname
or
ram:DIR1 ---> ram:DIR1/newdirectoryname
then click the gadget. The new directory will be
made and the current directory will be returned
to:
ram:
or
ram:DIR1 respectively.
The directory will be created in the highlighted
source window.
PARENT -
Go to the parent directory in the highlighted
source window.
WAND -
Used to flip the Source highlight from one widow
directory to the other.
5.3 Type/Display Functions
HTYPE -
Types a file to the screen in HEX and ASCII 16
numbers at a time.
PRINT -
THIS FUNCTION IS NOW RUN OF AS A BACKGROUND JOB!!!
Same as TYPE, but the output goes to PRT:
TYPE -
Use this to view standard ASCII (readme, docs,
etc) on stdout; usually your CRT. Select the
files you want to view, then select the TYPE
gadget. A new window, with the window name being
the file that you are currently viewing, will
open. Use the space bar to advance by one screen,
a <CR> will advance one line. Entering ESC will
advance you to the end of that file. The space
bar will then exit from that file. If you have
selected to view more than one file, the next will
automatically be displayed. After all selected
files have been viewed, the window will close,
returning you to DISK MAGIC's main screen.
5.4 File Functions
ARC -
Select all Files to be Archived in the source window
(highlighted), click in the parameter entry field and
enter the name of the new Archive (TEST). If the
destination directory is RAM: then (TEST.ARC) is the
file name. Then Select ARC. The archive name doesn't
need anything entered in the parameter entry field. It
will default to .ARC. The archive will be created in
the destination directory. If the destination
directory was RAM: then the archive will be created in
ram:TEST.ARC. If the destination is df0:DIR1 then the
ARC file name would be DF0:DIR1/TEST.ARC.
ARCLST -
This lists all files in the selected ARC files in
the highlighted source window.
ARCS -
ARCS each highlighted file as an individual
archive. This is great for doing multiple
archives of picture files etc. The archive name
will be the destination directory + the files's
name + .ARC.
ASSIGN -
This gives the system assign list.
BYTE -
Adds up the number of bytes of the selected files
in the highlighted source directory and displays
the sum and the number of files. Remember that
each file takes up 512 more bytes than indicated
because of its directory entry.
COPY -
Copy selected files and directories to the
directory specified in the unhighlighted
destination string gadget. It must be an existing
directory path and CAN go across devices. You
should be able to enter paths relative to the
current directory. NOTE! you can select both
directories and files to be copied now. and all
are done at the same time.
DELETE -
Delete selected files and directories in the
Highlighted source directory.
DINFO -
Used to show the number of USABLE bytes from the
DEVICE associated with the unhighlighted
destination directory.
DE-ARC -
Select one or more Arced files,then select DE-ARC.
The files will be un arced and placed on the
destination device and directory. This also works
in ram: If the file being DE_ARCED is already in
the destination directory DISK MAGIC will over
write the old file.
DE-ZOO -
Operates the same as DE-ARC.
EXECUTE -
Now executes an execute file selected in the
highlighted source window and passes the
parameters from the parameter entry field.
GRENAM -
This is a global rename function. Commands are
entered in the parameters entry field with the
following format.
+)abcd adds the characters 'abcd' to the
front of all highlighted files.
+(.pic Adds the characters '.pic' to the
back of all highlighted files.
-)3 Removes 3 characters from the front
of all highlighted files.
-(3 Removes 3 characters from the back
of all highlighted files.
#?abcd>efgh
This searches all files highlighted
for the string 'abcd' and replaces
the string with the string 'efgh'
fileabcd.pic->fileefgh.pic.
MOVE -
Same basic principle as RENAME, but assumes that
you want to just move the file to a new directory,
not actually rename it. It will move multiple
files from one directory to another.
MOVDEL -
This is like a rename between devices. What it
does is move files from the highlighted source
window to the unhighlighted destination window
from one device to another and then deletes the
source files.
PAK -
Operates the same as ARC.
NOTE: to un pack a file select the file in the
source window and click the RUN gadget.
PAKLST -
Operates the same as ARCLST.
RENAME -
Renames first selected file or directory to the
name or path specified in the highlighted source
directory.
ex: click on the highlighted string gadget and
enter the following:
ram: ---> ram:newdirectoryname
or
ram:DIR1 ---> ram:DIR1/newdirectoryname
then click the gadget. The file will be
renamed and the current directory will be
returned to:
ram:
or
ram:DIR1 respectively.
RUN -
"RUNS" the selected files from inside DISK MAGIC.
If DISK MAGIC was called from CLI, any output from
the program is directed to the calling CLI.
Parameters may be passed to the program by
entering them in the E window.
SHOW -
Select the IFF files you wish to display,
one or more, then click on the SHOW gadget. DISK
MAGIC will attempt to display these files. This
function will work with most, but not all forms of
IFF files. If DISK MAGIC can not display the
file, an error message will be displayed in the
error msg. window and DISK MAGIC will go on to the
next selection, if there is one. DISK MAGIC opens
a new screen for the IFF file, displays the file,
then waits for you to continue. When finished
viewing the image, click in the upper-left corner
of the image. There is an invisible close gadget
located there. DISK MAGIC will close the screen
and proceed to display the next file. The user
may also define a paused timer between files
instead of using the close gadget. See section
7.2.
SINFO -
Used to show the number of USABLE bytes from the
DEVICE associated with the highlighted source
directory.
ZOO -
Operates the same as the ARC function.
ZOOLST -
Operates the same as the ARCLST function.
6.0 USER DEFINED GADGETS AND MENUS
6.1 Directory Gadgets And Menus
Directory gadgets and a directory menu can be defined
by the user and the process to define these are
described is section 7.0.
6.2 Program Menus
Program menus are a set of 6 menus allowing for six
catagories of functions with 18 functions in each menu
can be defined by the user to execute their favorite
programs. The process to define these Menus are
described in section 7.0.
7.0 DISK MAGIC DEFINITION FILE
This directory utility can have multiple commands executed
by each menu item. See section 7.7 for details.
USER DEFINED FILE COMMANDS AND DIRECTORY GADGETS.
There are 14 USER definable on screen directory commands,
108 user definable menu commands, and 18 user definable menu
directories that can be defined in the file DISKMAGIC.data.
This file can be edited by any editor and contains 14 tables.
The following sections describe these tables.
7.1 Color mode definition
This value is either 4 or 8 indicating the number of
colors that the CLI graphics interface should use.
7.2 Archive Pause Timer
This value (0-99) indicates the pause time between
ARC lists and DE-ARC actions. If the value is one
then DISK MAGIC waits for user input of a carriage
return an (ESC) key or a (SPACE) key.
7.3 Picture Pause Timer
THis value (0-99) indicates the pause time between
picture displays for the show command. If the value is
one then DISK MAGIC then waits for the user to click
the hidden close box.
7.4 Sound On/Off
This flag turns the sound on or off.
1 = ON, 0 = OFF.
7.5 Start up Source Directory
***** CURRENT STARTUP DIRECTORIES #1 *****
df0:c
This defines the source directory of the highlighted
directory window at startup. At startup the program
will read in this directory as the starting source
directory. The size of this entry is 255 characters.
7.6 Startup Destination Directory
***** CURRENT STARTUP DIRECTORIES #2 *****
ram:
This defines the destination directory of the
unhighlighted window at startup. At startup the
program will read in this directory as the starting
destination directory. The size of this entry is 255
characters.
7.7 On Screen Directory Names
***** CURRENT DEFAULT DIRECTORY GADGET NAMES *****
DH0:
DH1:
DH2:
DH3:
RAM:
VD0:
ARC:
JH0:
JH1:
SYST
DF0:
DF1:
DF2:
C:
This next table in DISK MAGIC data defines the name of
the gadgets (4 characters in length). As you can see it
is possible to define a gadget called ARC: and then in
the next table in section 6.5 define the directory that
this gadget should get such as JH0:ARCHIVES/ARCHIVE1.
7.8 On Screen User Defined Directories
***** CURRENT DEFAULT DIRECTORIES ******
DH0:
DH1:
DH2:
DH3:
RAM:
VD0:
JH0:ARCHIVE
JH0:
JH1:
df0:system
DF0:
DF1:
DF2:
df0:C
This table as described above defines the directory the
user would like to get when the gadget is selected. As
another example the gadget defined as SYST when
selected would get DF0:SYSTEM. This entry can be 255
characters long.
7.9 Program Menu Catagories
******* 7 CURRENT USER DEFINED MENU HEADERS *****
DIRECTORY
WORDPROC
GRAPHICS
DESK TOP
VIDEO
ANIMATION
UTILITIES
The above table defines the 6 menu headers to
categorize the user defined commands. The first one is
default for the user defined menus described below.
7.10 User Defined Directory Menu Names
***** 18 USER DEFINED DIRECTORY MENU NAMES *****
C SOURCE
ARCHIVE
SYSTEM
The above table defines the menu item names of the
directories the user would like to define. Each entry
may be 9 characters in length.
7.11 User Defined Menu Directories
***** 18 USER DEFINED DIRECTORIES *****
JH0:CSOURCE
JH0:ARCHIVE
JH0:WBB/SYSTEM
The above table defines the directories that are
activated when the user selects a given menu item in
the directory menu. This field is 255 characters in
length.
7.12 User Defined Menu Program Names
***** 18 USER DEFINED FUNCTION NAMES MENU 1 *****
EDIT
***** 18 USER DEFINED FUNCTIONS NAMES MENU 2 *****
DELUXE PAINT
***** 18 USER DEFINED FUNCTIONS NAMES MENU 3 *****
CITY DESK
***** 18 USER DEFINED FUNCTIONS NAMES MENU 4 *****
SILVER
***** 18 USER DEFINED FUNCTIONS NAMES MENU 5 *****
SHWANI
***** 18 USER DEFINED FUNCTIONS NAMES MENU 6 *****
NEWZAP
NEWCLI
DISKCOPY DF0:->DF2:
FORMAT/INSTALL DF0:
FORMAT df0: E=NAME
ACCESS! ME!
COMPILE!
The next table found in DISKMAGIC.data and seen above
defines an 18 character menu name for the user
definable program menu item for each one of seven
menus.
7.13 User Defined Menu Programs
***** CURRENT USER DEFINED PROGRAM CALLS MENU 1 *****
E
***** CURRENT USER DEFINED PROGRAM CALLS MENU 2 *****
CD JH0:PAINT\RUN DPAINT
***** CURRENT USER DEFINED PROGRAM CALLS MENU 3 *****
CD JH0:CITYDESK\RUN CityDesk_v1.1
***** CURRENT USER DEFINED PROGRAM CALLS MENU 4 *****
SHOWANI -c
***** CURRENT USER DEFINED PROGRAM CALLS MENU 5 *****
SPLAYER
***** CURRENT USER DEFINED PROGRAM CALLS MENU 6 *****
CD JH0:WBBU\NEWZAP
jh0:wbb/c/NEWCLI
jh0:wbb/system/DISKCOPY <ram:CRT DF0: to DF2:
jh0:wbb/system/FORMAT <ram:crt DRIVE df0: name
"EMPTY"\INSTALL DF0:
JH0:WBB/SYSTEM/FORMAT <RAM:CRT DRIVE
CD JH0:TERMINALS\ACCESS!
CD JH0:MANIX\EXECUTE SETRAM\ED DISKMAGIC.c
The next table seen above is a 255 character entry that
defines the program name and parameters etc that you
would like for the user definable menu item to execute.
For each entry you can have multiple commands. This is
done by entering a '\' between each command. An example
of this is seen above for dpaint.
7.14 User Defined Comments
**
****** USER COMMENT DEFINITIONS MENU 1 *****
now editing selected file
****** USER COMMENT DEFINITIONS MENU 2 *****
now running DELUXE PAINT II
****** USER COMMENT DEFINITIONS MENU 3 *****
now running citydesk
****** USER COMMENT DEFINITIONS MENU 4 *****
now showing SILVER
****** USER COMMENT DEFINITIONS MENU 5 *****
now showing selected animations
****** USER COMMENT DEFINITIONS MENU 6 *****
now zapping selected file
opening a new CLI
now COPYING DF0: TO DF2:
ENTER NAME IN 'E' AS "NAME" AND CLICK AGAIN
ENTER NAME IN 'E' AS 'NAME "test"' AND CLICK AGAIN
now running ACCESS!
The next table seen above is a user defined comment he
or she would like displayed upon selecting the defined
menu item. This again is 255 characters in length.
7.15 User Menu Format Definitions
****** USER COMMAND FORMAT DEFINITIONS MENU 1 *******
301
****** USER COMMAND FORMAT DEFINITIONS MENU 2 *******
300
****** USER COMMAND FORMAT DEFINITIONS MENU 3 *******
300
****** USER COMMAND FORMAT DEFINITIONS MENU 4 *******
000
****** USER COMMAND FORMAT DEFINITIONS MENU 5 *******
000
****** USER COMMAND FORMAT DEFINITIONS MENU 6 *******
000
311
300
311
411
100
The above table is 3 characters in length. This
defines a set of 3 flags and are used as follows:
1. The first flag is a program format flag. The default
for this flag is 0. The following formats are defined
where:
PN = Is the Program name as defined in the table
described above called USER DEFINED PROGRAM CALLS.
This is the command line the user has defined that
is executed when a given menu item is selected.
EX = Is the 'P' window for entering parameters names
etc. Anything the user enters in the P: window
will be placed in the command string as defined
by the format number defined below.
SF = The current highlighted source files in the highlighted
source directory.
DD = The current destination directory.
SD = The current highlighted source directory and no
highlighted files as an example for diskcopy DF0:
to DF1:
SD = DF0:.
DD = The current unhighlighted destination
directory.
So for this function diskcopy Df0: Df1:
SD = DF0:
DD = DF1:
The following formats are defined
0. PN, EX, SF
1. PN, EX ,SD
2. PN, EX, SD, DD
3. PN, EX
4. PN, DD, EX
5. PN, EX, DD
6. PN, EX, DD, SD
7. PN, SD, EX
EXAMPLE:
Set PN to FORMAT DRIVE in the above table for the
program name entries. Set the first flag in the table
for the flags to 4. In the Parameters entry field enter
NAME "ARC DISK" and in the unhighlighted directory have
the directory DF2:
The command would execute as follows:
FORMAT DRIVE DF2: NAME "ARC DISK"
In most cases 0 would be acceptable and the others are
only used for programs that need directories specified
instead of files. In the case of format 0 and the program
is in MENU mode then the command line is passed as a
command with no files. This allows the user to still have
the ability to call programs such as scribble and specify
the command being a format 0 which says the program gets
passed a highlighted filename in graphics mode but in menu
mode he can still access scribble but he will not be able
to specify a file name.
All program command lines are validated and should not
give the user a system software error. If the command
is not valid then a warning message is generated saying
the command is invalid and also displays in the CLI window
the menu number and item number of the error.
All though the command line is validated it is possible to
generate a program software error as described in the
following example:
Define the command line as a format 3.
define the command line as follows:
RUN DPAINT
In this case DPAINT gives a system software error when
passed a directory name as a parameter. The program giving
the error is DPAINT so there is no way for DISK MAGIC to
check for this kind of error.
The next flag in the above table allows the user to
define the function as needing double click protection.
If this flag is set and the function is selected, DISK
MAGIC will ask you to select the function again to
activate the program. This is good for functions like
diskcopy or fformat or FORMAT. The last flag allows
the user to define this program to run in background
mode. If this is set the function will execute
and be run behind the DISK MAGIC screen on the
workbench screen and will allow DISK MAGIC to be free
for other actions. If a program is run in background
you must click on the back gadget to get to the
workbench screen to use the function. If the program
is executed the DISK MAGIC screen automatically send
the workbench screen to the front so as to allow the
user to see the function. Upon exiting the function
such as edit the workbench screen is placed in the back
with the DISK MAGIC SCREEN in the front.
8.0 ALPHABETICAL LIST OF COMMANDS
PRE DEFINED FILE COMMANDS
ALL -
Select ALL files in the current highlighted source
directory, including the ones "scrolled off" the
window.
ALLDRS -
Highlights all directories.
ALLWND -
Highlights all files in the highlighted source window
(9 at a time). This is handy for archiving a directory
that is two large for a 3 1/2" disk.
ARC -
Select all Files to be Archived in the source window
(highlighted), click in the parameter entry field and
enter the name of the new Archive (TEST). If the
destination directory is RAM: then (TEST.ARC) is the file
name. Then Select ARC. The archive name doesn't need
anything entered in the parameter entry field. It will
default to .ARC. The archive will be created in the
destination directory. If the destination directory was
RAM: then the archive will be created in ram:TEST.ARC. If
the destination is df0:DIR1 then the ARC file name would be
DF0:DIR1/TEST.ARC.
ARCLST -
This lists all files in the selected ARC files in the
highlighted source window.
ARCS -
ARCS each highlighted file as an individual archive
This is great for doing multiple archives of picture
files etc. The archive name will be the destination
directory + the files's name + .ARC.
ASSIGN -
This gives the system assign list.
BYTE -
Adds up the number of bytes of the selected files
in the highlighted source directory and displays the
sum and the number of files. Remember that each file
takes up 512 more bytes than indicated because of its
directory entry.
CATLIST -
This will list all files and directories and sub files
and sub directories to the printer. This function
starts from the Highlighted source directory found in
the highlighted directory window.
CLEAR -
De-select all selected files in the highlighted source
directory.
CLRDIRS -
Clears all selected directories in the highlighted
source directory.
CLRWIND -
Clears all files in the highlighted source window.
COPY -
Copy selected files and directories to the directory
specified in the unhighlighted destination string
gadget. It must be an existing directory path and CAN
go across devices. You should be able to enter paths
relative to the current directory.
NOTE! you can select both directories and files to be
copied now. and all are done at the same time.
DE-ARC -
Select one or more Arced files,then select DE-ARC.
The files will be un arced and placed on the
destination device and directory. This also works in
ram: If the file being DE_ARCED is already in the
destination directory DISK MAGIC will over write the
old file.
DE-ZOO -
Operates the same as DE-ARC.
DELETE -
Delete selected files and directories in the
Highlighted source directory.
DINFO -
Used to show the number of USABLE bytes from the DEVICE
associated with the unhighlighted destination
directory.
EXECUTE -
Now executes an execute file selected in the
highlighted source window and passes the parameters
from the parameter entry field.
GETDIR -
GETS the current directory in the highlighted source
window. You can also click on the directory windows and
then type in a new directory. Upon hitting carriage
return the new directory is read in.
GRENAM -
This is a global rename of multiple files.
Commands are entered in the parameter entry filed with
the following format.
+)abcd Adds the characters 'abcd' to the
front of all highlighted files.
+(.pic Adds the characters '.pic' to the
back of all highlighted files.
-)3 Removes 3 characters from the front of
all highlighted files.
-(3 Removes 3 characters from the back of
all highlighted files.
#?abcd>efgh
This searches all files highlighted for
the string 'abcd' and replaces the
string with the string 'efgh'!
fileabcd.pic -> fileefgh.pic
HTYPE -
Types a file to the screen in HEX and ASCII 16
numbers at a time.
MAKDIR -
This will create the directory that you have typed in
the highlighted source window gadget. You MAY use
relative paths.
ex: click on the highlighted string gadget and
enter the following:
ram: ---> ram:newdirectoryname
or
ram:DIR1 ---> ram:DIR1/newdirectoryname
then click the gadget. The new directory will be
made and the current directory will be returned
to:
ram:
or
ram:DIR1 respectively.
The directory will be created in the highlighted
source window.
MOVE -
Same basic principle as RENAME, but assumes that
you want to just move the file to a new directory, not
actually rename it. It will move multiple files from
one directory to another.
MOVDEL -
This is like a rename between devices. What it does is
move files from the highlighted source window to the
unhighlighted destination window from one device to
another and then deletes the source files.
PAK -
Operates the same as ARC.
NOTE: to un pack a file select the file in the
source window and click the RUN gadget.
PAKLST -
Operates the same as ARCLST.
PARENT -
Go to the parent directory in the highlighted source
window.
PRINT -
THIS FUNCTION IS NOW RUN OF AS A BACKGROUND JOB!!!
Same as TYPE, but the output goes to PRT:
RENAME -
Renames first selected file or directory to the
name or path specified in the highlighted source
directory.
ex: click on the highlighted string gadget and
enter the following:
ram: ---> ram:newdirectoryname
or
ram:DIR1 ---> ram:DIR1/newdirectoryname
then click the gadget. The file will be renamed
and the current directory will be returned to:
ram:
or
ram:DIR1 respectively.
RUN -
"RUNS" the selected files from inside DISK MAGIC.
If DISK MAGIC was called from CLI, any output from the
program is directed to the calling CLI. Parameters
may be passed to the program by entering them in the E
window.
SHOW -
Select the IFF files you wish to display, one or more,
then click on the SHOW gadget. DISK MAGIC will attempt
to display these files. This function will work with
most, but not all forms of IFF files. If DISK MAGIC
can not display the file, an error message will be
displayed in the error msg. window and DISK MAGIC will
go on to the next selection, if there is one.
DISK MAGIC opens a new screen for the IFF file,
displays the file, then waits for you to continue.
When finished viewing the image, click in the
upper-left corner of the image. There is an invisible
close gadget located there. DISK MAGIC will close the
screen and proceed to display the next file. Also see
section 7.2 for the ability to select a timer pause to
show pictures. Future updates are planned for v2.0.
SINFO -
Used to show the number of USABLE bytes from the DEVICE
associated with the highlighted source directory.
TYPE -
Use this to view standard ASCII (readme, docs, etc) on
stdout; usually your CRT. Select the files you want to
view, then select the TYPE gadget. A new window, with
the window name being the file that you are currently
viewing, will open. Use the space bar to advance by
one screen, a <CR> will advance one line. Entering ESC
will advance you to the end of that file. The space
bar will then exit from that file. If you have
selected to view more than one file, the next will
automatically be displayed. After all selected files
have been viewed, the window will close, returning you
to DISK MAGIC's main screen.
WAND -
Used to flip the Source highlight from one widow
directory to the other.
ZOO -
Operates the same as the ARC function.
ZOOLST -
Operates the same as the ARCLST function.
APPENDIX A. COPYRIGHT NOTICES
PKAX by PAKWARE
PKAX FAST! Archive Extract Utility Version 1.0
12-08-87 Copyright (c) 1987, PKWARE Inc. All rights reserved.
PKAX -h for help.
Extracts files from an archive to their original name, size,
time, & date.
Usage: PKAX [options] archive [file...]
Options are:
-r = replace existing files
-v = verbose listing of archive(s)
-c = extract file(s) to screen
-p = extract file(s) to printer
-t = test archive integrity
-l = display software license
-e,-x = extract file(s)
archive Archive file name, wildcards *,? ok. Default extension
is .ARC file Names of files to extract. Wildcards *,? ok.
Default is ALL files.
If you find PKAX fast, easy, and convenient to use, a
registration of $25 would be appreciated. With each
registration of $50 or more you will be registered to receive a
diskette with the next version of PKAX & PKARC
when available. PLEASE state the current version of the
software which you have. Send contributions to:
PKWARE, Inc.
7032 Ardara Avenue
Glendale, WI 53209
ZOO COPYRIGHT NOTICE
AmigaZoo is a user supported program. Zoo was written
by Rahul Dhesi and modified to run on the Amiga by J.
Brian Waters. With the consent of the author, I am
requesting a $10-$20 contribution from satisfied users.
This contribution is voluntary and you need not feel any
guilt if you do not contribute. Any contributions
received will go toward one of three things: firstly,
and most importantly, they will be used to acquire any tools
which may appear on the market to help make AmigaZoo
better, like more optimizing C compilers or better
debuggers; secondly, it will be used to help defray the
costs of distributing Zoo; thirdly, if any money is still
remaining it will be used to buy some shares of Commodore stock.
In any case, you are encouraged to use and distribute this
program in accordance with the conditions below.
AmigaZoo is a derivative work of a program copyrighted by
Rahul Dhesi and as such is subject to the following
limitations on distribution:
Distribution of the executable AmigaZoo is permitted
subject to the following conditions. Any violation of
these conditions may lead to damages in favor of the
copyright owner.
AmigaZoo 2.00 may be duplicated and distributed, or
made available for downloading via telecommunications,
for no fee above normal connect charges. It is
prohibited to distribute AmigaZoo with any copyright
notices removed. It is prohibited to distribute
AmigaZoo and not allow the recipient to redistribute
it. This file should be included in any distribution
of AmigaZoo.
Please note that AmigaZoo has different distribution conditions
than the portable version of Zoo. These conditions allow
any telecommunications service which does not claim a
compilation right or charge a surcharge to distribute the
AmigaZoo executable. These conditions allow AmigaZoo to be
included on a disk sold at any price so long as you allow the
recipient to redistribute AmigaZoo.
Bug reports, suggestions, contributions etc. should be sent to:
US Mail: J. Brian Waters
c/o The Mackey Residence
1307 Alden Rd.
Muncie, IN 47304
ARC COPYRIGHT NOTICE
AmigArc - Archive utility, Version 0.16, created on 07/17/86 at
19:01
Compatible with ARC v5.0
(C) COPYRIGHT 1986 by Raymond S. Brand; ALL RIGHTS RESERVED
(C) COPYRIGHT 1985,86 by System Enhancement Associates; ALL
RIGHTS RESERVED
Please refer all inquiries to:
Raymond S. Brand
c/o The Lido Hotel (a Fido BBS, node 16/630)
(203) 248-7324
or AMuse (a Fido BBS, node 107/134)
(212) 269-4879
You may copy and distribute this program freely, provided that:
1) No fee is charged for such copying and distribution, and
2) It is distributed ONLY in its original, unmodified
state.
If you like this program, and find it of use, then your
contribution will be appreciated. You may not use this
product in a commercial environment or a governmental
organization without paying a license fee of $35 Site licenses
and commercial distribution licenses are available. A program
disk and printed documentation are available for $50.
If you fail to abide by the terms of this license, then your
conscience will haunt you for the rest of your life.
Usage: ARC {amufdxerplvtc}[bswn][g<password>] <archive>
[<filename> . . .]
Where: a = add files to archive
m = move files to archive
u = update files in archive
f = freshen files in archive
d = delete files from archive
x,e = extract files from archive
p = copy files from archive to standard output
l = list files in archive
v = verbose listing of files in archive
t = test archive integrity
c = convert entry to new packing method
b = retain backup copy of archive
s = suppress compression (store only)
w = suppress warning messages
n = suppress notes and comments
g = Encrypt/decrypt archive entry
PAK COPYRIGHT NOTICE
*** PAK Documentation ***
File PAKer 1.0 - November 2, 1987
Copyright 1987 by Mark Riley
All rights reserved.
*** Description ***
PAK is a utility for combining and compressing several
smaller files into one large file. The PAKed file may then be
uploaded to a BBS or another computer. Transmission time is
reduced because PAKed files are compressed. Also, the receiving
party does *not* require any special program to unPAK the files
- PAKed files unPAK themselves! Unlike other utilities of its
type, PAK imposes no restrictions on filenames. PAK's small size
(under 5K) makes it handier than those written in high-level
languages (PAK is written in 68000 Assembly Language.) PAK is
simple to use, so have fun!
This program is ShareWare; it isn't free. If you like it (or
use it) please send a $10 contribution to the following
address:
Mark Riley - Pak
P.O. Box 234
Simi Valley, CA 93062
Thank you! This contribution will help me to provide further
low cost utilities for the Amiga (I've already got several
queued up.) You may freely redistribute PAK in its original
unaltered state.
FIZ
NAME
fiz - analyze damaged zoo archive for data recovery
AUTHOR
Rahul Dhesi
SYNOPSIS
fiz archive[.zoo]
DESCRIPTION
Fiz is used to analyze damaged zoo archives and
locate directory entries and file data in them. The
current version of fiz is 2.0 and it is meant to be
used in conjunction with zoo version 2.0.